home *** CD-ROM | disk | FTP | other *** search
/ BMUG Revelations / BMUG Revelations.toast / Entertainment / Strategy / NetHack 3.1.3 / Owner's Manual [nh313.doc] < prev    next >
Text File  |  1993-07-27  |  8KB  |  175 lines
  1. (Message inbox:163)
  2. Return-Path: jwalz@mons.er.usgs.gov
  3. Received: by henry.ece.cmu.edu (5.54-ECE2/5.17)
  4.     id AA04150; Mon, 26 Jul 93 17:23:33 EDT
  5. Received: by mons.er.usgs.gov (4.1/SMI-4.1)
  6.     id AA05860; Mon, 26 Jul 93 17:19:19 EDT
  7. Date: Mon, 26 Jul 93 17:19:19 EDT
  8. From: jwalz@mons.er.usgs.gov (Janet Walz)
  9. Message-Id: <9307262119.AA05860@mons.er.usgs.gov>
  10. To: brh@apple.com, d88-jwa@nada.kth.se, dean@natinst.com, hywang@apple.com,
  11.         izchak@linc.cis.upenn.edu, jhandler@ils.nwu.edu,
  12.         jwalz@mons.er.usgs.gov, mtc@henry.ece.cmu.edu, rgm@cory.berkeley.edu,
  13.         swanson@snoopy.msc.cornell.edu
  14. Subject: nh313.doc.bin
  15.  
  16. NetHack 3.1 for the Macintosh
  17.  
  18. Owner's Manual and Installation Guide
  19.     for nh313.hqx - BinHex 4.0 encoded, self-extracting, game archive
  20.  
  21. === License
  22.     The following is an excerpt from the NetHack license which is
  23. explicitly included in this distribution and is also available for
  24. reading from within the game (using the command sequence ?i).  By
  25. reading this material or by playing the game, you implicitly agree
  26. to be bound the terms of that license.
  27.  
  28. ----------------
  29. Stated plainly:  You are prohibited by the terms of this License Agreement
  30. from using NetHack for gainful purposes.  You are permitted to modify
  31. NetHack, or otherwise use parts of NetHack, provided that you comply with
  32. the conditions specified above; in particular, your modified NetHack or
  33. program containing parts of NetHack must remain freely available as provided
  34. in this License Agreement.  In other words, go ahead and share NetHack, but
  35. don't try to stop anyone else from sharing it farther.
  36. ----------------
  37.  
  38.  
  39. === Installation
  40.     Before installing the latest version of NetHack 3.1, you should
  41. trash any previous NetHack files, with the exception of 'Record' from
  42. a previous NetHack 3.1 dungeon.  System 7 users should also trash the
  43. 'NetHack Windows' file in their system 'Preferences' folder (this will
  44. be especially useful to small screen users).  The latest distribution
  45. contains all the files you need to play the game.  Furthermore, keeping
  46. the older files will create problems with the new distribution.  You
  47. may choose to substitute your old 'Record' file in place of the
  48. distributed file, in order to retain your previous scoreboard
  49. statistics.
  50.  
  51.     To install the game NetHack 3.1, you will need a hard drive with
  52. a minimum of 3.5MB of free space.  You then need to decode the BinHex
  53. encoded archive to get the application which can then be launched to
  54. self-extract all the NetHack and dungeon-related files.  You can save
  55. space by trashing the BinHex endoded archive after decoding the
  56. self-extracting application a/o by trashing that application after
  57. generating the Dungeon folder, which uses ~1.8M bytes of disk space.
  58.  
  59.  
  60. === The Dungeon Folder and related files
  61.     Contained in the Dungeon folder are the files and file types:
  62. NetHack          - application itself.
  63. Recover          - crash recovery utility application.
  64. NetHack Defaults - text file for editing option settings.
  65. Record           - scoreboard file.
  66. special levels   - *.lev files containing customized level data.
  67. utility files    - various help and privately-used files.
  68.  
  69.     The files below are generated during or after playing a game:
  70. logfile          - listing of all games played.
  71. bones files      - the internally-used remains of deceased players.
  72. level files      - game-in-progress files (i.e. 1Adriane.0, etc.).
  73. save files       - saved game bundle (i.e. save/1Adriane).
  74.  
  75.     Window position preferences are stored in: NetHack Windows
  76. which may be found in the Dungeon folder or, for System 7 users, the
  77. system "Preferences" folder.  The windows will revert to default sizes
  78. and locations if this file is trashed.
  79.  
  80.     When the logfile gets too large, you can trash it and a new one
  81. will be created.  You can also trash old save files a/o bones files.
  82. You should not trash any of the other files, however you may trash
  83. level files _not_ belonging to a game in progress or you may process
  84. those files with the Recover application (see below).
  85.  
  86.     Please read the Macintosh-specific help text from within the game
  87. (command ?j), for more details about these files and other topics.
  88.  
  89.  
  90. === Starting a Game
  91.     If you are running system software 6.0.2 or better on any Macintosh
  92. then you can open (double-click) the application NetHack contained in
  93. the Dungeon folder or double-click the "Open NetHack" file.  If you are
  94. restarting a previously saved game then you can simply double-click
  95. that file.  If you are prompted "Who are you?" then enter a suitable
  96. character name and then, if necessary, determine a desired role for
  97. your character.  After the game is underway you should read the help
  98. info made available by using the ? command.  Initially, the help
  99. sections related to commands, options and Macintosh-specific help will
  100. be of most interest.  By default, the options are configured to get you
  101. started easily, however you should, at some point, reconfigure the
  102. settings to match your preferences.
  103.  
  104.     NetHack has a minimum partition of 1.0MB, however most users will
  105. prefer a partition of around 1.5M bytes.  Also, ~1.5M bytes of disk
  106. space should be reserved in order to complete a given game.
  107.  
  108.  
  109. === Explore and Debug Modes
  110.     Normally you will play a game in the Regular mode.  However, some
  111. players would like to learn more about the game.  Discover (or Explore)
  112. mode has been provided to allow you to play a regular game but with
  113. some advantages: you start the game with a wand of wishing, you can see
  114. your intrinsic attributes (i.e. poison resistance, etc.) at any time
  115. using the command ctl-X, and you are given an oppurtunity at death to
  116. override your demise and continue playing.  The price you pay for
  117. Discover mode advantages is that your score is not recorded on the high
  118. scores list.  Playing in Discover mode can be rewarding.
  119.  
  120.     Wizard (or Debug) mode is only intended for NetHack developers who
  121. need to be able to probe and analyze the game in order to, for example,
  122. fix bugs or improve game features.  This mode is not intended for the
  123. casual player and using this mode inappropriately will ruin your
  124. enjoyment of the game.  If you are not a developer, DO NOT USE
  125. WIZARD-MODE!
  126.  
  127.  
  128. === Option Editing and Preferences
  129.     Eventually, you will want to adjust a few of the many options
  130. available in the game.  Option help is accessed from within the game
  131. by either of the command sequences ?f or ?g.  You can set default
  132. preferences to be used by every game by editing the text file:
  133. NetHack Defaults.  TeachText is a suitable editor application but
  134. you can use any text editor that you like.  For your convenience,
  135. you can enter options on one-line or over multiple lines, as in:
  136. OPTIONS=time,!tombstone,female,showexp,showscore
  137. OPTIONS=dogname:Rowf,catname:Meow
  138. OPTIONS=name:Adriane
  139.  
  140.  
  141. === Recover
  142.     In the event that NetHack crashes, you will need to run the utility
  143. application, Recover, to restore a save file from the various level
  144. files generated during play.  Leave the level files as they are and
  145. simply open (double-click) Recover to start it up.  Select 'Open...'
  146. from the 'File' menu and then select the (level 0) file corresponding
  147. to the game that you want to recover.  If Recover was able to restore
  148. a save file then you'll get an 'OK:' message else you'll get a 'Sorry:'
  149. message with a brief error description.  A successful recovery will
  150. restore your game back to the point of the last level change.  In order
  151. to be able to recover a game, you need to have the 'checkpoint' option
  152. (default TRUE) enabled during play.  If you need to abort a recovery
  153. before it completes (thus making it impossible to restore the save file)
  154. you can simply press the '.' key while holding down the command (apple)
  155. key or simply Quit the Recover application altogether.  Doing this
  156. will destroy any chance you have of recovering that game.
  157.  
  158.     You should not run Recover on level files that are still being
  159. played while NetHack is running.  This could result in losing both the
  160. save file and the current game as well!
  161.  
  162.     For the curious, Recover will display memory diagnostics if you
  163. hold down the option key while selecting 'About Recover...' from the
  164. apple menu.
  165.  
  166. === Support
  167.     Installation questions, comments, suggestions, and so on should
  168. be e-mailed to the internet address:
  169.  
  170. To: nethack-bugs@linc.cis.upenn.edu
  171. Subject: Macintosh NetHack 3.1
  172.  
  173. The members of the Macintosh NetHack Port Team hope you enjoy the
  174. latest release of NetHack 3.1 for the Macintosh.
  175.